Skip to content

vignette: reader-facing prose cleanup (PARS)#230

Merged
NewGraphEnvironment merged 3 commits into
mainfrom
vignette-prose-cleanup
Jul 6, 2026
Merged

vignette: reader-facing prose cleanup (PARS)#230
NewGraphEnvironment merged 3 commits into
mainfrom
vignette-prose-cleanup

Conversation

@NewGraphEnvironment

Copy link
Copy Markdown
Owner

Summary

Reader-facing prose polish on the PARS vignette, from review feedback — no artifact or numbers change.

  • Dropped internal issue numbers from the rendered prose + a code comment (the vignette no longer cites #221/#223/#226, and drops the "before/after the fix" framing).
  • Removed "tunnel" references — build infrastructure the reader needn't know about.
  • Cut the mapping_code disagreement detail — the top diff pattern / count columns, their explanatory caption sentence, and the "remaining disagreements concentrate on…" paragraph. The match is ~99%, so the near-zero diff isn't worth belabouring.
  • Kept the accessible / spawning / rearing km comparison table, reframed: lnk_rollup_wsg() is a standalone roll-up (link's own habitat totals, no reference required) that happens to match bcfishpass — rather than a proof-of-parity exercise.

Net −12 lines. Verified with a database-free knit — the comparison table and the computed map captions render, and the flagged content is gone.

Follow-up to #226. SRED: NewGraphEnvironment/sred#24.

🤖 Generated with Claude Code

https://claude.ai/code/session_014kSEJoad4Bc553qU8eFiE6

NewGraphEnvironment and others added 3 commits July 4, 2026 20:41
Follow-up polish on the PARS vignette from review feedback: drop internal issue numbers, remove 'tunnel' references (build infra the reader needn't know), and cut the mapping_code disagreement detail (top-diff-pattern columns + caption + the 'remaining disagreements' paragraph) since the diff is negligible. The accessible/spawning/rearing km comparison table stays, reframed as link's own routine roll-up (lnk_rollup_wsg is standalone — needs no reference) that happens to match bcfishpass. Verified with a database-free knit.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014kSEJoad4Bc553qU8eFiE6
The symbology paragraph said 'a purple segment sits below a dam' — inverted. Verified against R/lnk_pipeline_mapping_code.R (token 2 = most-relevant barrier DOWNSTREAM, emitted only when the species' blocking barriers downstream are empty) and the PARS data (every coloured reach has has_barriers_bt_dnstr = false; the 58,916 blocked reaches carry no code). Rewritten: only accessible reaches are coloured; colour names the most-significant structure downstream (necessarily non-blocking for the species) with all five classes + their colours (blue none / orange modelled / red assessed-PSCIS / purple dam / green remediated); width carries habitat use.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014kSEJoad4Bc553qU8eFiE6
Per review: the prose kept mis-stating the colour semantics (esp. red = a PSCIS crossing ranked BARRIER, not just any field-assessed crossing), and the per-map legend already carries the colour key. Cleaner to remove the whole paragraph than to keep chasing exact wording.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014kSEJoad4Bc553qU8eFiE6
@NewGraphEnvironment NewGraphEnvironment merged commit bceffc1 into main Jul 6, 2026
1 check passed
@NewGraphEnvironment NewGraphEnvironment deleted the vignette-prose-cleanup branch July 6, 2026 18:51
NewGraphEnvironment added a commit that referenced this pull request Jul 6, 2026
#230 PARS vignette reader-facing prose cleanup (issue numbers, tunnel refs, disagreement detail removed; accessible km table reframed as standalone roll-up; mapping_code symbology paragraph dropped). Docs only.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014kSEJoad4Bc553qU8eFiE6
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant